home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / scherz programme / explode / config.doc < prev    next >
Text File  |  1996-04-07  |  4KB  |  123 lines
  1.                                   config
  2.                                   ------
  3.           Documentation for version 1.2b, on September 12th, 1991
  4.  
  5.                               by Bruno Costa
  6.  
  7.  
  8.  
  9. DESCRIPTION
  10.  
  11.   Config is a program used to configure an explode executable to
  12. automatically use your custom defaults, including a new path for exploding
  13. the windows.
  14.  
  15.  
  16. OPTIONS
  17.  
  18.   usage: config <executable>
  19.  
  20.   The required parameter is the full pathname of a explode v1.2b executable
  21. that  will be modified to reflect the new configuration.  The configuration
  22. itself  is read from stdin in the form of ASCII numbers, with the following
  23. meaning:
  24.  
  25.   <delay> <pattern>
  26.   <TL1x> <TL1y>   <BR1x> <BR1y>
  27.   <TL2x> <TL2y>   <BR2x> <BR2y>
  28.  
  29.   ...
  30.  
  31.   <TL30x> <TL30y>   <BR30x> <BR30y>
  32.   [EOF]
  33.  
  34.   <delay>  is  an  integer  number  ranging  from 0 to 2, that has the same
  35. meaning of the corresponding options in explode.
  36.  
  37.   <pattern>  is  an *hex* number that gives the arbitrary line pattern used
  38. to  draw the moving outlines.  It is a line pattern as used by the graphics
  39. library function SetDrPt().
  40.  
  41.   The  numbers in the form <TL??> are used to describe the path followed by
  42. the  Top-Left  corner  of  the outline; <BR??> points form the path for the
  43. Bottom-Right  corner.   These numbers are given in decimal form, and may be
  44. even  negative.   Note that the path must have at least one pair of points,
  45. and  at most 30 pairs.  The numbers for the top-left and bottom-right paths
  46. may  be  equal  (as  is  the  case  with the default path), but this is not
  47. necessarily  so,  since  each  path  is treated separately.  The origin for
  48. these  paths  (point (0,0)) is always the point where the mouse pointer is.
  49. The  ending  point  for  each path (either the top-left or the bottom right
  50. corner  of  the  window after it is open) is always point (1024,1024).  The
  51. points  for the path may be anywhere between these limits, and even outside
  52. them.   Note  that usually the first point of each path is (0,0) - to start
  53. at  the  mouse  pointer - and the ending point is (1024,1024) - to end just
  54. where  the  window will open -, but you may try starting or ending the path
  55. somewhere else.
  56.  
  57.   Note that if you omit the numbers describing the path, it will remain the
  58. same and just the other parameters will be changed.
  59.  
  60.  
  61. EXAMPLES
  62.  
  63.   To set the explode executable at c: to use a delay of 1, a dotted line
  64. pattern and the default path:
  65.  
  66.   > config <figfile c:executable
  67.  
  68.   where figfile contains:
  69.  
  70.   1 0x5555
  71.      0    0    0    0
  72.    135  -22  135  -22
  73.    265  -30  265  -30
  74.    389  -25  389  -25
  75.    506   -6  506   -6
  76.    615   23  615   23
  77.    717   62  717   62
  78.    811  111  811  111
  79.    895  168  895  168
  80.    971  231  971  231
  81.   1036  300 1036  300
  82.   1090  373 1090  373
  83.   1134  449 1134  449
  84.   1166  527 1166  527
  85.   1186  605 1186  605
  86.   1194  683 1194  683
  87.   1188  759 1188  759
  88.   1169  833 1169  833
  89.   1135  902 1135  902
  90.   1087  966 1087  966
  91.   1024 1024 1024 1024
  92.   [EOF] <- simply the end of the file
  93.  
  94.  
  95. BUGS
  96.  
  97.   Config should have been more user-friendly.
  98.  
  99.  
  100. AUTHOR
  101.  
  102.   The  accompanying  program  and  this documentation were written by Bruno
  103. Costa.  He can be reached in the following ways:
  104.  
  105.   E-Mail: bruno@brlncc.bitnet (InterNet)
  106.           bruno@BRLNCC        (BitNet)
  107.  
  108.   Mail:   Bruno Costa
  109.           Rua Almirante Guilhem 454/102 bloco 1
  110.           Leblon - Rio de Janeiro
  111.           RJ 22440
  112.           BRAZIL
  113.  
  114.  
  115. COPYRIGHT
  116.  
  117.   This program is copyrighted by Bruno Costa.  It may be freely distributed
  118. if  and  only  if the the documentation and the executables are provided in
  119. original form.  It may be included in Public Domain/Shareware compilations,
  120. like  the  one  organized  by  Fred  Fish, as long as just a nominal fee is
  121. charged  for  each  disk  (no  more  than  US$10 per disk), and may also be
  122. uploaded to BBS's or network services like BIX and CompuServe.
  123.